The Installer for the “E.T.O. #1” CD release is located in the “Installer Folder”. Drag this folder onto the hard disk where you wish to install MPW, MacApp, etc. and open the folder. Double-click on the Installer icon. You will be presented with a Commando dialogue allowing several different means of installation.
There are two radio buttons at the top of the Installer dialogue; “Easy” and “Custom”. Easy is the default, and allows the you to select any of a number of choices by clicking on the check-box to the left of the name. There are three versions of MPW (3.0, 3.1 and EXP1), MacApp 2.0, two versions of C++ (3.1b1 and 3.1b4), three versions of SADE (1.0, 1.1, and 1.2b1) which correspond to the MPW versions, two versions of MacsBug (6.1 and 6.2a4), two versions of ResEdit (1.2 and 2.0b2) and two choices for the MPW 411 help system.
Note: Special characters in your disk/folder names may cause errors in the installer. For example, you should avoid characters such as quotes (“ or ‘) in your hard disk name.
••• Warning: This Installer was created specially for E.T.O. as an informal project. It has not received the exhaustive testing that conventional software products get. The “Easy” Installation feature is relatively robust and automatic, but “Custom” Installation requires the user to correctly indicate which folders each product must be installed into. Failure to tell Installer the right destination folder(s) may cause the installer to place items in such a way that the installed software will not work properly. For the best results, install using the processes outlined in the Manual and Release Notes for each product on E.T.O.
EASY INSTALLATION:
Note: If you are not installing MPW (i.e. you are installing a different tool or 411), you MUST move your MPW folder (renamed to “MPW Folder”) to the top level of your hard drive. The Installer will then add your selected items into this folder. If you do not add this folder, the Installer will fail.
MPW / SADE Installation:
Any of the three versions of MPW may be installed. For best results with C++ and MPW 411, the EXP1 version is recommended. You will note that when an MPW version is selected, only the SADE version immediately to to right is selectable (If you pick a SADE version, only the MPW to the left is immediately selectable). This ensures that the correct versions of SADE and MPW are always installed. MPW will be installed on the hard drive in a folder called “MPW Folder”. SADE will be installed in a folder called “SADE Folder” and the Installer will automatically update the MultiFinder and CD Handler files in the System Folder for use with SADE (The older versions will be renamed “MultiFinder.Old” and “DA Handler.Old” respectively). Note: you must restart your machine after installing SADE in order for the newer MultiFinder to be loaded.
MacApp Installation:
To install MacApp 2.0, click the check-box. MPW 3.1 or MPW 3.2b1 is recommended for best results. MacApp 2.0 will be installed in a folder inside the “MPW Folder” called “MacApp_Folder”. Note: in order to use MacApp, you must move the file “UserStartup•MacApp” from the “MacApp_Folder” to the “MPW Folder”. This is done automatically with the Installer “Easy” option.
C++ Installation:
Either of the versions of C++ may be installed by clicking in the check-box. MPW 3.1 or MPW 3.2b1 is recommended for best results. C++ will be integrated into the MPW environment, replacing some of the files inside the “MPW Folder”.
MacsBug Installation:
Either of the two versions of MacsBug may be installed. If selected, the MacsBug files will be installed in a folder called “MacsBug Folder”. The Installer will also update the version of MacsBug in the System Folder, renaming the older version (if it exists) to “MacsBug.Old”. Note: you must restart your machine after installing MacsBug in order for the newer MacsBug to be loaded.
ResEdit Installation:
Either of the two versions of ResEdit may be installed. If selected, the ResEdit environment will be installed in a folder called “ResEdit Folder”. ResEdit will work with any version of MPW.
MPW 411 Installation:
MPW 411 is a new Help utility for MPW EXP1. The MPW 411 Help system may be installed in one of two ways. The “Tools Only” installation copies the “Get” tool and “UserStartup•Help” files into the MPW folder. The “Complete” Installation will also copy all of the 411 data files into a folder called “Help Folder” within the MPW Folder. The “Complete” installation requires approximately 12 megabytes of disk space for the data files. If you are using the “E.T.O. #1” CD on a file server, you may use the “Tools Only” installation and, the first time you launch MPW, will ask where the 411 files are located. Point to the “E.T.O. #1:Essentials:MPW 411” folder and this path will be stored for future reference. If you choose the “Tools Only” option, you will not be able to access the MacApp 411 information unless you specifically instruct 411 to switch to the MacApp 411 folder on E.T.O.
CUSTOM INSTALLATION:
Custom installation is invoked by clicking on the “Custom” button at the top of the Installer dialogue. The “Easy” Installation selections are dimmed and may no longer be selected, but the buttons towards the bottom are now accessible. The “From” button lets you select what you wish to install. The “To” directory button allows you to specify a the installation is to be done. The “Custom Options” button displays a secondary dialogue with some additional options.
The default on the “Custom” installation is to update an existing version. If you wish to replace all of the files in the destination (“To”) folder, click on the “Install” radio button. If you wish to revert to an earlier version of the software, click on the “Revert” button.
The redirection buttons allow you to force the both standard output and error output from the Installer to a specific location or file. The “Show Progress” button will cause additional information to be displayed during the installation process.
Troubleshooting:
Problem:
You receive the error message “### Installer - 's must occur in pairs.” during installation.
Solution:
• Your hard disk has a single quote (') in its name. Simply remove it during installation.
Problem:
You installed MacApp, but you can’t issue MacApp commands from the shell. The MPW shell does run, however.
Solution:
• Check if the Installer had enough space on your hard disk to completely install MacApp. MacApp requires a significant amount of disk space, and may partially install. If the “MacApp” folder does not appear inside “MPW Folder,” the Installer ran out of disk space.
Problem:
The MPW tools appear to install correctly, but the shell reports that it cannot swap in tool segments.
Solution:
• Be sure that the MPW Shell has a large enough memory partition to function. Refer to the product documentation under system requirements for each MPW component.